.TH E1432_SET_CAL_DAC 3 E1432
.SH NAME
.nf
e1432_set_cal_dac \- Set calibration DAC value
e1432_get_cal_dac \- Get current value of calibration DAC
.fi
.IX e1432_set_cal_dac(3) 3
.IX e1432_get_cal_dac(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_cal_dac(E1432ID hw, SHORTSIZ16 ID,
                             SHORTSIZ16 cal_dac)
SHORTSIZ16 e1432_get_cal_dac(E1432ID hw, SHORTSIZ16 ID,
                             SHORTSIZ16 *cal_dac)
.cE
.SH DESCRIPTION
This is a low-level function that is normally not used.  Instead, use
\fIe1432_set_cal_voltage\fR to control the calibration DAC output
voltage.

\fIe1432_set_cal_dac\fR sets the E1432 internal calibration DAC value,
of a single channel or group of channels \fIID\fR, to the value given
in \fIcal_dac\fR.

\fIe1432_get_cal_dac\fR returns the current setting of the internal
calibration DAC, of a single channel or group of channels \fIID\fR,
into a memory location pointed to by \fIcal_dac\fR.

This parameter is a "global" parameter.  It applies to an entire E1432
module rather than to one of its channels.  The \fIID\fR parameter is
used only to identify which module the function applies to, and all
channels in that module will report the same value for this parameter.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIcal_dac\fR determines the DAC setting.  This should be an integer
between -2048 and 2047.  This value is written directly to the
calibration DAC.  The voltage produced at the DAC output depends on
the setting of \fIcalin\fR (see \fIe1432_set_calin\fR and
\fIe1432_set_cal_voltage\fR).
.SH "RESET VALUE"
After a reset, \fIcal_dac\fR is set to \fB0\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_calin, e1432_set_cal_voltage, e1432_set_source_output,
e1432_set_sumbus
.ad
